revCloseCursor
Type
command
Summary
Closes a record set (database cursor).
Syntax
revCloseCursor <recordSetID>
Description
Use the revCloseCursor command to clean up after using a record set in a database.
All open record sets are closed automatically when the database they are associated with is closed. However, it is recommended practice to explicitly close record sets when your stack is finished with them.
The revCloseCursor command is part of the Database library. To ensure that the command works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure both the "Database" library checkbox and those of the database drivers you are using are checked.
Parameters
| Name | Type | Description |
|---|---|---|
recordSetID | The number returned by the revQueryDatabase function when the record set was created. |
Examples
revCloseCursor 3
revCloseCursor finalResults
Related
glossary: Standalone Application Settings, database, standalone application, record set, command, LiveCode custom library
library: Database library
command: revCloseDatabase
function: revDatabaseCursors, revdb_disconnect, revQueryDatabase, revDataFromQuery, revdb_closecursor
Compatibility and Support
Introduced
LiveCode 2.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile